---
slug: "/usage-guide/extensions/official/mdx"
title: "MDX"
---

The MDX extension installs a custom remote transformer with support for MDX syntax.

## Installation

From the _Extensions_ side panel, in the _Available_ section, find _MDX_ and click **Install**. The MDX extension has no configuration options.

![Vrite MDX extension](https://assets.vrite.io/65017ed7b0e627e259623b8a/Wr16k8SByLPCNzmKzy1LN.png)

Upon successful installation, you should see a new **MDX** transformer registered in the _Settings → Transformers_ section.

![MDX transformer](https://assets.vrite.io/65017ed7b0e627e259623b8a/Qbnyei1WcRw8ew0O38stA.png)

## Usage

When configuring _Git sync_, in the _Mapping_ section, update the following settings:

- _Match pattern_ — edit the pattern to include `.mdx` files (e.g. `**/*.{md,mdx}`);
- _Transformer_ — select **MDX**;

![](https://assets.vrite.io/65017ed7b0e627e259623b8a/fxjxR-pRk4ofEdB8atjuO.png)

The MDX transformer has extended capabilities compared to the built-in **Markdown** transformer, including:

- Support for **MDX block elements** with JSON-parsable parameters (mapping to Vrite’s Element blocks);
- Support for `title` and `meta` properties in code blocks;
- Support for **YAML frontmatter** (mapping to content piece metadata in Vrite)

![Content synced with MDX transformer](https://assets.vrite.io/65017ed7b0e627e259623b8a/9_F_Gs8KRxpyOHfacfC8X.png)